linux设备树笔记 |
您所在的位置:网站首页 › linux 注释符 › linux设备树笔记 |
ARM Device Tree起源于OpenFirmware (OF),在过去的Linux中,arch/arm/plat-xxx和arch/arm/mach-xxx中充斥着大量的垃圾代码,相当多数的代码只是在描述板级细节,而这些板级细节对于内核来讲,不过是垃圾,如板上的platform设备、resource、i2c_board_info、spi_board_info以及各种硬件的platform_data。为了改变这种局面,Linux社区的大牛们参考了PowerPC等体系架构中使用的Flattened Device Tree(FDT),也采用了Device Tree结构,许多硬件的细节可以直接透过它传递给Linux,而不再需要在kernel中进行大量的冗余编码。 Device Tree是一种描述硬件的数据结构,由一系列被命名的结点(node)和属性(property)组成,而结点本身可包含子结点。所谓属性,其实就是成对出现的name和value。在Device Tree中,可描述的信息包括(原先这些信息大多被hard code到kernel中):CPU的数量和类别,内存基地址和大小,总线和桥,外设连接,中断控制器和中断使用情况,GPIO控制器和GPIO使用情况,Clock控制器和Clock使用情况。 通常由.dts文件以文本方式对系统设备树进行描述,经过Device Tree Compiler(dtc)将dts文件转换成二进制文件binary device tree blob(dtb),.dtb文件可由Linux内核解析,有了device tree就可以在不改动Linux内核的情况下,对不同的平台实现无差异的支持,只需更换相应的dts文件,即可满足,当然这样会增加内核的体积。
设备树的存储格式:
简单的说,设备树是一种描述硬件配置的树形数据结构, 有且仅有一个根节点[4]。它包含了有关CPU、物理内存、总线、串口、PHY以及其他外围设备信息等。该树继承了Open Firmware IEEE 1275设备树的定义。操作系统能够在启动时对此结构进行语法分析,以此配置内核,加载相应的驱动。 U-Boot需要将扁平设备树在内存地址传给内核。该树主要由三大部分组成:头(Header)、结构块(Structure block)、字符串块(Strings block)。在内存中分配图如下:
------------------------------ base -> | struct boot_param_header | ------------------------------ | (alignment gap) (*) | ------------------------------ | memory reserve map | ------------------------------ | (alignment gap) | ------------------------------ | | | device-tree structure | | | ------------------------------ | (alignment gap) | ------------------------------ | | | device-tree strings | | | -----> ------------------------------ | |
--- (base + totalsize)
头(header) 头主要描述设备树的一些基本信息,例如设备树大小,结构块偏移地址,字符串块偏移地址等。偏移地址是相对于设备树头的起始地址计算的。 struct boot_param_header { __be32 magic; //设备树魔数,固定为0xd00dfeed __be32 totalsize; //整个设备树的大小 __be32 off_dt_struct; //保存结构块在整个设备树中的偏移 __be32 off_dt_strings; //保存的字符串块在设备树中的偏移 __be32 off_mem_rsvmap; //保留内存区,该区保留了不能被内核动态分配的内存空间 __be32 version; //设备树版本 __be32 last_comp_version; //向下兼容版本号 __be32 boot_cpuid_phys; //为在多核处理器中用于启动的主cpu的物理id __be32 dt_strings_size; //字符串块大小 __be32 dt_struct_size; //结构块大小 };
结构块(struct block)
设备树结构块是一个线性化的结构体,是设备树的主体,以节点node的形式保存了目标单板上的设备信息。 在结构块中以宏OF_DT_BEGIN_NODE标志一个节点的开始,以宏OF_DT_END_NODE标识一个节点的结束,整个结构块以宏OF_DT_END结束。一个节点主要由以下几部分组成。 (1)节点开始标志:一般为OF_DT_BEGIN_NODE。 (2)节点路径或者节点的单元名(version=0x10以节点单元名表示) (3)填充字段(对齐到四字节) (4)节点属性。每个属性以宏OF_DT_PROP开始,后面依次为属性值的字节长度(4字节)、属性名称在字符串块中的偏移量(4字节)、属性值和填充(对齐到四字节)。 (5)如果存在子节点,则定义子节点。 (6)节点结束标志OF_DT_END_NODE。
字符串块
通过节点的定义知道节点都有若干属性,而不同的节点的属性又有大量相同的属性名称,因此将这些属性名称提取出一张表,当节点需要应用某个属性名称时直接在属性名字段保存该属性名称在字符串块中的偏移量。
设备树源码 DTS 表示
设备树源码文件(.dts)以可读可编辑的文本形式描述系统硬件配置设备树,支持 C/C++方式的注释,该结构有一个唯一的根节点“/”,每个节点都有自己的名字并可以包含多个子节点。设备树的数据格式遵循了 Open Firmware IEEE standard 1275。这个设备树中有很多节点,每个节点都指定了节点单元名称。每一个属性后面都给出相应的值。以双引号引出的内容为 ASCII 字符串,以尖括号给出的是 32 位的16进制值。这个树结构是启动 Linux 内核所需节点和属性简化后的集合,包括了根节点的基本模式信息、CPU 和物理内存布局,它还包括通过/chosen 节点传递给内核的命令行参数信息。
machine_desc结构
内核提供了一个重要的结构体struct machine_desc ,这个结构体在内核移植中起到相当重要的作用,内核通过machine_desc结构体来控制系统体系架构相关部分的初始化。machine_desc结构体通过MACHINE_START宏来初始化,在代码中, 通过在start_kernel->setup_arch中调用setup_machine_fdt来获取。 struct machine_desc { unsigned int nr; /* architecture number */ const char *name; /* architecture name */ unsigned long atag_offset; /* tagged list (relative) */ const char *const *dt_compat; /* array of device tree* 'compatible' strings */ unsigned int nr_irqs; /* number of IRQs */ #ifdef CONFIG_ZONE_DMA phys_addr_t dma_zone_size; /* size of DMA-able area */ #endif unsigned int video_start; /* start of video RAM */ unsigned int video_end; /* end of video RAM */ unsigned char reserve_lp0 :1; /* never has lp0 */ unsigned char reserve_lp1 :1; /* never has lp1 */ unsigned char reserve_lp2 :1; /* never has lp2 */ enum reboot_mode reboot_mode; /* default restart mode */ struct smp_operations *smp; /* SMP operations */ bool (*smp_init)(void); void (*fixup)(struct tag *, char **,struct meminfo *); void (*init_meminfo)(void); void (*reserve)(void);/* reserve mem blocks */ void (*map_io)(void);/* IO mapping function */ void (*init_early)(void); void (*init_irq)(void); void (*init_time)(void); void (*init_machine)(void); void (*init_late)(void); #ifdef CONFIG_MULTI_IRQ_HANDLER void (*handle_irq)(struct pt_regs *); #endif void (*restart)(enum reboot_mode, const char *); };
设备节点结构体
struct device_node { const char *name; //设备name const char *type; //设备类型 phandle phandle; const char *full_name; //设备全称,包括父设备名 struct property *properties; //设备属性链表 struct property *deadprops; //removed properties struct device_node *parent; //指向父节点 struct device_node *child; //指向子节点 struct device_node *sibling; //指向兄弟节点 struct device_node *next; //相同设备类型的下一个节点 struct device_node *allnext; //next in list of all nodes struct proc_dir_entry *pde; //该节点对应的proc struct kref kref; unsigned long _flags; void *data; #if defined(CONFIG_SPARC) const char *path_component_name; unsigned int unique_id; struct of_irq_controller *irq_trans; #endif };
属性结构体
struct property { char *name; //属性名 int length; //属性值长度 void *value; //属性值 struct property *next; //指向下一个属性 unsigned long _flags; //标志 unsigned int unique_id; };
基本数据格式
————————————————————————————————
device tree是一个简单的节点和属性树,属性是键值对,节点可以包含属性和子节点。下面是一个.dts格式的简单设备树。 [html] view plain copy ![]() 该树并未描述任何东西,也不具备任何实际意义,但它却揭示了节点和属性的结构。即: 一个的根节点:'/',两个子节点:node1和node2;node1的子节点:child-node1和child-node2,一些属性分散在树之间。 属性是一些简单的键值对(key-value pairs):value可以为空也可以包含任意的字节流。而数据类型并没有编码成数据结构,有一些基本数据表示可以在device tree源文件中表示。 文本字符串(null 终止)用双引号来表示:string-property = "a string" “Cells”是由尖括号分隔的32位无符号整数:cell-property = 二进制数据是用方括号分隔:binary-property = [0x01 0x23 0x45 0x67]; 不同格式的数据可以用逗号连接在一起:mixed-property = "a string", [0x01 0x23 0x45 0x67], ; 逗号也可以用来创建字符串列表:string-list = "red fish", "blue fish"; 基本概念 ———————————————————————————————— 为了帮助理解device tree的用法,我们从一个简单的计算机开始, 手把手创建一个device tree来描述它。 例子 假设有这样一台计算机(基于ARM Versatile),由“Acme”制造并命名为"Coyote's Revenge": 一个32位的ARM CPU连接到内存映射串行端口的处理器本地总线(processor local bus),spi bus controller, i2c controller, interrupt controller, 和external bus bridge256MB SDRAM,起始地址为0两个串口起始地址为0x101F1000,0x101F2000GPIO controller,起始地址为0x101F3000SPI controller起始地址为0x10170000,并挂载以下设备:MMC插槽(SS管脚连接到GPIO #1)External bus bridge,挂载以下设备:SMC SMC91111以太网设备连接到external bus,基地址0x10100000i2c controller起始地址为0x10160000,并挂载以下设备:Maxim DS1338 real time clock.响应从机地址1101000 (0x58)64MB NOR flash,基地址0x30000000 初始结构 第一步,先构建一个计算机的基本架构,即一个有效设备树的最小架构。在这一步,要唯一地标志这台计算机。 [html] view plain copy ![]() ![]() ![]() 警告:不要使用通配符compatible值,如"fsl,mpc83xx-uart"等类似表达,芯片厂商总会改变并打破你的通配符假设,到时候再想修改就为时已晚了。相反,你应当选择一个特定的芯片实现,并与所有后续芯片保持兼容。 编址 ———————————————————————————————— 可编址的设备使用下列属性来将地址信息编码进设备树: reg#address-cells#size-cells 每个可寻址的设备有一个reg属性,即以下面形式表示的元组列表:reg = 每个元组表示该设备的地址范围。每个地址值由一个或多个32位整数列表组成,被称做cells。同样地,长度值可以是cells列表,也可以为空。 既然address和length字段是大小可变的变量,父节点的#address-cells和#size-cells属性用来说明各个子节点有多少个cells。换句话说,正确解释一个子节点的reg属性需要父节点的#address-cells和#size-cells值。让我们从CPU开始,添加编址属性到示例设备树。 CPU编址 Each CPU is assigned a single unique ID, and there is no size associated with CPU ids. 谈到编址,最简单的例子就是CPU节点。每个CPU被分配了一个唯一的ID,并且不存在与CPU ids的相关大小信息。 [html] view plain copy ![]() 在cpus节点中,#address-cells为1,#size-cells为0,这意味着子寄存器值是一个uint32,是一个不包含大小字段的地址。在本例中,两个CPU被分配为地址0和1。cpu节点的#size-cells为0,是因为只为每个CPU分配了地址值。你一定注意到了,reg值与节点名中的值是匹配。按照惯例,如果一个节点有reg属性,则节点名称必须包含unit-address属性,unit-address属性值是reg属性中的第一个地址值。
注:ePAPR中对cell的定义是”一个包含32bit信息的单元“。 内存映射设备 与CPU节点中的单一地址值不同,内存映射设备会被分配一个它能响应的地址范围。#size-cells用来说明每个子节点种reg元组的长度大小。在下面的示例中,每个地址值是1 cell (32位) ,并且每个的长度值也为1 cell,这在32位系统中是非常典型的。64位计算机可以在设备树中使用2作为#address-cells和#size-cells的值来实现64位寻址。 [html] view plain copy![]() ![]() ![]() 我们已经讨论过如何分配地址给设备,但在这些地址只是设备节点可见的,还没有描述如何将这些地址映射成CPU可使用的地址。根节点总是从CPU的角度描述地址空间。 如果根节点的子节点已经使用了CPU地址域,就不需要任何显式映射了,例如,串口serial@101f0000被直接分配到地址0x101f0000。 如果根节点的间接子节点没有使用CPU的地址域,为了获得一个内存映射地址,设备树必须指定如何翻译地址。 下面是一个添加了ranges属性的示例device tree。 [html] view plain copy![]() ranges是地址翻译表,由3个数组成,即,分别对应子节点的#address-cells值,父节点的#address-cells值,子节点的#size-cells值确定。对于本例中的外部总线,子节点的地址是2个单元,父节点的地址是1个单元,子节点的区域大小是1个单元。 3个ranges被转换: 从片选0偏移0被映射到地址范围0x10100000~0x1010ffff 从片选1偏移0被映射到地址范围0x10160000~0x1016ffff 从片选2偏移0被映射到地址范围为0x30000000~0x30ffffff 另外,如果父节点和子节点的地址空间是相同的,那么一个节点可以添加一个空的ranges属性。一个空的ranges属性的存在意味着子节点地址空间的地址1:1地映射到父地址空间。你可能会问,你可能会问,为如果可以都用一一映射,为什么还需要地址转换?这是因为一些总线(如PCI )具有完全不同的地址空间,其细节需要暴露给操作系统。其他有DMA engine的计算机需要知道总线上的真实地址。有时设备需要组合在一起,因为他们都有着相同的软件可编程的物理地址映射。是否需要一一映射取决于操作系统所需要的信息,以及硬件设计。你也应该注意到,在i2c@1,0节点上没有ranges属性。这样做的原因是,不像外部总线,I2C总线上的设备不是内存映射到CPU地址域的。相反,CPU通过i2c@1,0设备间接访问rtc@58设备。ranges属性为空意味着设备不能被除了父设备以外的任何设备直接访问。 另举一例说明ranges属性 soc { compatible = "simple-bus"; #address-cells = ; #size-cells = ; ranges = ;serial { device_type = "serial"; compatible = "ns16550"; reg = ; clock-frequency = ; interrupts = ; interrupt-parent = < &ipic >; } } soc的ranges属性指定了,从物理地址为0x0大小为1024KB的子节点映射到了物理地址为0xe0000000的父地址空间,有个这层映射关系,串口设备节点就可以通过load/store地址0xe0004600来访问,即0x4600的偏移+在ranges中指定的映射0xe0000000。 当然在64位操作系统中也会看到这样的映射,不要感到吃惊啦,"0xf 0x00000000"一起组成父节点地址即f00000000 dcsr: dcsr@f00000000 { ranges = ; };中断如何工作 ———————————————————————————————— 与地址范围转换遵循树的天然结构不同,一台计算机的任何设备都可以发起和终止中断信号。不像设备编址,中断信号表现为独立于树的节点之间的链接。描述中断连接有4个属性: interrupt-controller - 一个空的属性定义该节点为接收中断信号的设备#interrupt-cells - 这是中断控制器节点的属性。它声明了中断控制器的中断说明符有多少个cell(类似#address-cells和#size-cells) 。interrupt-parent - 设备节点的属性,包含一个指向该设备所连接中断控制器的pHandle。那些没有interrupt-parent属性节点则从它们的父节点继承该属性。interrupts - 设备节点属性,包含中断说明符列表,对应于该设备上的每个中断输出信号。 中断说明符是一个或多个cell的数据(由#interrupt-cells指定),指定设备连接到哪些中断输入。下面的例子中,大多数设备只有一个中断输出,但也有一个设备上有多个中断输出的情况。一个中断符的含义完全取决于绑定的中断控制器设备。每个中断控制器可以决定它需要多少cell来唯一地确定一个中断输入。 下面的代码将中断添加到我们的Coyote's Revenge: [html] view plain copy ![]() 这台机器只有一个中断控制器interrupt-controller@10140000,标签'intc:'被添加到中断控制器节点,该标签用于给根节点中的interrupt-parent属性分配一个phandle。这个interrupt-parent值将成为系统默认值,所有子节点都继承它,除非它被显式覆盖。每个设备用一个interrupt属性来指定一个不同的中断输入线。#interrupt-cells是2,所以每个中断符有2个单元。本例使用通用格式,第一个cell代表中断线号码,第二个cell代表标志位,如高电平触发/低电平触发,边沿触发/水平触发。对于一个给定的中断控制器,请参阅控制器binding文档,以了解如何对说明符进行编码。 设备特有的数据 ———————————————————————————————— 除了公共属性,任意属性和子节点都可以作为节点添加。只要遵循一些规则,操作系统所需要的任何数据可以被添加。首先,设备新的特有属性名应当使用制造商前缀,这样它们不会与现有的标准属性名称冲突。第二,属性和子节点的含义必须有文档来约束,这样一个设备驱动程序的作者才能知道如何解释这些数据。约束记录了一个特定的compatible值代表什么,它应该有什么样的属性,它可能有什么子节点,代表什么设备。每个唯一的compatible值应该有自己的约束(或者声明与其他compatible值的兼容性)。绑定新设备都记录在本wiki页。第三,发布新的约束到[email protected]邮件列表上进行审查。审查新的约束的确发现了很多未来会导致问题的常见错误。 特殊节点 ———————————————————————————————— 别名节点 特定节点通常通过完整路径引用,如/external-bus/ethernet@0,0,但当用户真正想要知道的是哪个设备是eth0时,这很不具有易读性,别名节点可分配一个短的alias给一个完整的设备路径。例如: [html] view plain copy ![]() ![]() |
今日新闻 |
推荐新闻 |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |